从零搭建Typecho博客：半小时搞定的轻量级方案

说实话，我见过太多人为了搭个博客折腾WordPress，动辄要求2G内存、还要装MySQL，最后卡在数据库配置上直接劝退。今天咱们换个思路，用Typecho——一个只有几百KB的轻量级博客程序，配合SQLite数据库和Nginx，不需要复杂的环境，一台低配云服务器就能跑得很流畅。我自己用这套方案给朋友搭了十几个站，最久的一个已经稳定运行两年多，今天把完整流程分享出来。

一、环境准备：PHP + SQLite + Nginx

Typecho对PHP版本要求不高，5.4到8.2都能跑，但建议用PHP 7.4+，性能和兼容性更好。SQLite是文件型数据库，无需单独安装服务，PHP装上pdo_sqlite扩展即可。Nginx作为Web服务器，配置起来比Apache简单。

我用的是雨云服务器，性价比高，新人还有优惠。如果你还没有服务器，可以看看雨云服务器（优惠码：aabh），2G内存的机器跑Typecho绰绰有余。系统我推荐Debian 11或Ubuntu 22.04，下面以Debian为例。

先更新系统并安装所需软件：

apt update && apt upgrade -y
apt install -y nginx php-fpm php-sqlite3 php-mbstring php-curl unzip

这里要特别注意：PHP的版本要和Nginx的fastcgi配置匹配。安装完成后，PHP-FPM默认监听Unix socket（通常是/run/php/php7.4-fpm.sock），我们后面配置站点时要引用这个路径。

启动服务并设置开机自启：

systemctl enable --now nginx php-fpm

二、下载并安装Typecho

Typecho的官网下载页面经常更新，但稳定版可以从GitHub获取。我建议下载最新的1.2.1正式版，下载地址在Typecho GitHub Releases。下载后解压到网站目录：

mkdir -p /var/www/typecho
cd /var/www/typecho
wget https://github.com/typecho/typecho/releases/download/v1.2.1/typecho.zip
unzip typecho.zip
chown -R www-data:www-data /var/www/typecho

这里把www-data设为所有者，是为了让PHP-FPM进程能够写入Typecho的配置文件和上传目录。很多新手卡在安装界面无法写入配置，多半是权限问题。

三、配置Nginx站点

在/etc/nginx/sites-available/下创建一个配置文件，比如typecho.conf：

server {
listen 80;
server_name yourdomain.com;  # 改成你的域名或IP
root /var/www/typecho;
index index.php index.html;
伪静态规则，Typecho的URL美化就靠它if (!-e $request_filename) {
rewrite ^(.*)$ /index.php$1 last;
}
location ~ .php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php7.4-fpm.sock;
}
location ~* .(jpg|jpeg|gif|png|css|js|ico|xml)$ {
expires 30d;
access_log off;
}
}

这段配置里最关键的是rewrite规则，它让Typecho支持自定义URL结构（比如/archives/123.html）。没有它，所有文章链接都会变成?p=123的形式，不美观也不利于SEO。

启用站点并检查配置：

ln -s /etc/nginx/sites-available/typecho.conf /etc/nginx/sites-enabled/
nginx -t
systemctl reload nginx

如果nginx -t报错，99%是fastcgi_pass的路径写错了，检查一下你的PHP版本对应的socket文件名。

四、浏览器端安装与基础配置

现在打开浏览器，访问你的域名或IP，会看到Typecho的安装引导。数据库类型选择SQLite，数据库文件路径保持默认即可。填写管理员用户名和密码，点击“开始安装”，几秒钟就完成了。

安装完成后，进入后台（/admin），建议先做这几件事：

在“设置”里修改站点地址，确保是完整域名（含http://或https://）；
在“永久链接”中启用自定义URL结构，推荐/archives/{cid}.html；
在“插件”中启用自带的Markdown解析插件，写文章更方便。

五、主题选择与个性化

Typecho的主题市场虽然没有WordPress那么庞大，但精品不少。我个人推荐几款：Default（官方默认，简洁）、VOID（响应式，适合极简风格）、handsome（功能丰富，适合折腾）。在后台“外观”中直接启用，也可以把下载的主题文件夹上传到/usr/themes/目录。

如果你想自定义样式，编辑/usr/themes/你的主题/style.css即可。记得先备份，改坏了还能还原。

六、常见问题与解决

我在帮朋友安装时遇到最多的问题有三个，这里一并说明：

问题1：安装时提示“无法连接到数据库”
原因是PHP没有安装SQLite扩展。执行apt install php-sqlite3然后重启PHP-FPM即可。

问题2：文章页面404
多半是伪静态规则没生效。检查Nginx配置中的rewrite段是否正确，并确认include snippets/fastcgi-php.conf;没有被注释掉。

问题3：上传图片失败或无法写入配置
这是目录权限问题。执行chown -R www-data:www-data /var/www/typecho，然后刷新页面重试。

另外提醒一点：Typecho默认没有后台安全验证码，建议修改后台路径（把admin目录改名），或者用Nginx配置IP白名单限制访问，防止暴力破解。

七、总结与思考

整个流程走下来，真正动手的时间不超过半小时。Typecho的优势在于轻、快、简单，没有多余的功能，适合专注写作的人。当然，它的插件和主题生态不如WordPress丰富，如果你需要复杂的商城、会员系统，那还是老实选WordPress。但如果你只是想拥有一块干净的写作自留地，Typecho绝对是性价比最高的选择之一。

搭建完成只是第一步，后续的SEO优化、备份策略、HTTPS配置，我会在后面的文章中继续分享。有任何问题，欢迎在评论区留言，我看到都会回复。祝你的博客之旅顺利！